home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / blast10.arc / BLASTER.DOC next >
Text File  |  1991-05-28  |  5KB  |  120 lines
  1.                              BLASTer v1.0
  2.  
  3.                    Integrated ASCII File Prep Utility
  4.  
  5.                          By:  George Spafford
  6.  
  7. Purpose:
  8.  
  9.       Blaster was developed to allow the preprocessing of data files
  10.       into a flat ASCII format by weeding out extended ascii characters
  11.       and control characters.  It also partially fills the need to perform
  12.       a quick analysis of data files and log the results.
  13.  
  14. Procedure:
  15.  
  16.       BLASTER.EXE runtime file for this package.  You can rename it if you
  17.       so desire.  Once it is executed, the user is prompted for the input
  18.       and output file names.  These two names can NOT be duplicates.  The
  19.       program is purposefully designed to make a user keep a backup file.
  20.       By leaving the input file name blank and then pressing enter, the
  21.       registration screen will appear and the program will then terminate.
  22.  
  23.       Once the filenames are entered and verified, the user is then presented
  24.       with the main menu.   At this time, there are seven choices:
  25.  
  26.                 1.      Remove Blanks
  27.                 2.      Analyze and LOG
  28.                 3.      Repair CR/LF ends
  29.                 4.      Strip to flat ASCII
  30.                 5.      Run the entire battery
  31.                 R.      Display registration information
  32.                 0.      QUIT
  33.  
  34.       One at a time:
  35.  
  36.       1.        Remove Blanks
  37.  
  38.       This will read in the input file, weed out all blank lines and then
  39.       save the corrected data to the output file.  If there are blank lines
  40.       after this module executes, you might want to check for space holders
  41.       like decimal 20.  Since it is a character, even though you can't see it,
  42.       BLASTer avoids removing the line "just-in-case."
  43.  
  44.       2.        Analyze and LOG
  45.  
  46.       This analyzes the lines/records in the data file.  A log file is then
  47.       appended to the output file that you specify.  The log contains and also 
  48.       reports the time and the date of the analysis, blank lines encountered, 
  49.       minimum record length and maximum record length.  Since there are tons
  50.       of editors and viewers, I will let you use your favorite to view the
  51.       log file.  It is a simple flat ascii (DOS text) file.
  52.       
  53.       3.        Repair CR/LF Ends
  54.  
  55.       Unfortunately, some programs require that DOS records end with
  56.       carriage return and line feed characters (Decimal 13 and 10 respectively).
  57.       And, as you might guess, some programs save data with just one or the
  58.       either.  This module attempts to add a CR/LF to each record.  It will NOT
  59.       parse streamed data files.  CUTit (available on Queued Access) or
  60.       something similar must be used.
  61.  
  62.       4.        Strip to Flat ASCII
  63.  
  64.       This reads in a file byte by byte.  Each byte is analyzed and unless it
  65.       is a carriage return, line feed, standard printer character (between
  66.       decimal 31 and 127) or the true EOF (End of File) marker, it is discarded.
  67.       Note, this module processes data until the bytes read equals the byte
  68.       size reported by DOS - it does NOT process to the EOF marker.  Thus, it
  69.       can eliminate extra EOF characters.
  70.  
  71.       5.        Run the Entire Battery
  72.   
  73.       This battery of tests will create an intermediary file entitled
  74.       BV10$$$.TMP in the active DOS directory.  The program will process
  75.       the data files and perform each of the above tests.
  76.  
  77.       0.        Quit
  78.  
  79.       This displays the registration screen and terminates the program.
  80.   
  81.       R.        Registration
  82.   
  83.       You guessed it - it's the registration screen once again!
  84.   
  85.       I hope this program helps you evaluate some of your problems
  86.       or even makes some solutions/benefits clear.  This program is
  87.       distributed as shareware.  It is NOT public domain.  If you would
  88.       like me to be able to continue providing specialized software at a
  89.       shareware price, I would appreciate $10.  This price is based on
  90.       concurrent use - i.e. a license for one computer to use this is $10
  91.       or if there are 10 computers, but only 5 use this program at any
  92.       concurrent time, then the price is $10 x 5 machines = $50.
  93.       Please send payments (no cash please) or comments to:
  94.  
  95.              Sincerely,
  96.  
  97.              George Spafford
  98.              3001 LakeShore Drive, #329
  99.              St. Joseph, MI 49085
  100.  
  101.       Data:  (616) 468-5026  Queued Access BBS 2400-8-N-1
  102.                              FIDOnet 1:227/250
  103.  
  104.  
  105.  
  106.       BLASTER IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES NO
  107.       WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
  108.       TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
  109.       WITH RESPECT TO THIS SOFTWARE AND DOCUMENTATION.  IN NO EVENT SHALL THE
  110.       AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST SAVINGS,
  111.       OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE
  112.       OR THE INABILITY TO USE THIS PROGRAM.
  113.       ------------------------------------------------------------------------
  114.  
  115.  
  116.  
  117.  
  118.              
  119.  
  120.